home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / sharew / accs / jetfd131 / jetfind.man < prev    next >
Encoding:
Text File  |  1991-03-27  |  12.8 KB  |  266 lines
  1. JetFind 1.31                                                     27.3.1991
  2. ============
  3.  
  4. (c) 1990,1991 Dirk Steins
  5.  
  6.  
  7. DIE IDEE
  8. ========
  9.  
  10. Die Idee zu JetFind stammt von dem Accessory 'Dateien finden' vom Apple
  11. Macintosh. Zwar gibt es auf dem ST auch schon eine ganze Reihe Programme, die
  12. in der Lage sind, Dateien auf der Harddisk zu lokalisieren, aber alle geben
  13. auf einen TOS-Bildschirm aus und man kann auch nicht in der Ausgabe blättern.
  14. Deshalb habe ich JetFind geschrieben, um diesem Mißstand abzuhelfen. Außerdem
  15. ist JetFind auch noch extrem schnell beim Suchen der Dateien, da es direkt auf
  16. der Platte sucht und nicht die langsamen Funktionen des Betriebssystems
  17. benutzt.
  18.  
  19.  
  20. DIE FEATURES
  21. ============
  22.  
  23. JetFind hat eine komplette GEM-Oberfläche, die gefundenen Dateien werden in
  24. einer Liste angezeigt, in der man Blättern kann, zu den gefundenen Dateien
  25. kann man sich weitere Informationen anzeigen lassen (Größe, Datum und Uhrzeit
  26. der letzten Änderung, Dateiattribute).
  27. Sämtliche Dialoge sind tastaturbedienbar, auch die Popup-Menus (Cursor-Tasten
  28. und Return, Abbruch mit Undo)!
  29. Es werden erweiterte Wildcards unterstützt.
  30. JetFind ist schnell. Genauer: JetFind ist schneller als jedes andere mir
  31. bekannte Programm zum Dateien suchen.
  32. Außerdem kann man auch noch eine Liste der gefundenen Dateien auf das Clipboard
  33. ausgeben lassen. Wahlweise kann man diese Ausgabe auch an eine schon vorhandene
  34. Liste anhängen.
  35. JetFind arbeitet jetzt auch mit GEMINI zusammen, d.h. man kann
  36. unter GEMINI Dateien mittels JetFind suchen und dann von JetFind das Fenster
  37. mit dem Pfad einer gefundenen Datei öffnen oder auch die Datei direkt öffnen,
  38. also Ansehen, Drucken oder, im Falle eines Programmes, auch starten.
  39.  
  40.  
  41. Die Bedienung
  42. =============
  43.  
  44. JetFind läuft sowohl als Accessory als auch als eingeständiges Programm.
  45. Die Umschaltung erledigen Sie einfach durch Umbennen von JETFIND.ACC in
  46. JETFIND.PRG. Sie geben den Namen der zu suchenden Datei in dem editierbaren
  47. qeld 'Suchen nach:' ein, wobei Sie auch Joker wie '*' und '?' benutzen können.
  48. Sie können auch wie in GEMINI nur Teilbereiche von Zeichenfolgen angeben, so
  49. z.B. findet 'JET[FR]*' nur Dateien, die z.B. JETFIND oder JETRSC heißen, nicht
  50. jedoch JETSTRM. Genaueres dazu steht unter WILDCARDS.
  51. Durch einen Klick auf 'Start' oder einen Druck auf die 'Return'-Taste wird
  52. die Suche begonnen. Sobald die Suche beendet ist, werden die gefundenen Dateien
  53. in der Liste angezeigt. Über den seitlichen Scrollbalken können Sie in der
  54. Liste beliebig vorwärts und rückwärts blättern. Die Dateien werden unsortiert
  55. angezeigt, also in der Reihenfolge, in der Sie gefunden wurden.
  56.  
  57. Wenn Sie auf einen Eintrag in der Liste klicken, erscheint normalerweise ein
  58. Dialog mit Informationen über das angeklickte File. Wenn Sie jedoch gerade in
  59. GEMINI sind, erscheint stattdessen ein Popup-Menu, in dem Sie drei Möglich-
  60. keiten zur Auswahl haben:
  61.    1) Info:    Es erscheint der Informations-Dialog
  62.    2) Fenster: Es wird an GEMINI der Befehl gesendet, das Fenster mit dem
  63.                Pfad der Datei und der gewählten Auswahlmaske zu öffnen.
  64.    3) öffnen:  Es wird an GEMINI der Befehl gesendet, die Datei zu öffnen.
  65.                Falls die Datei in GEMINI als ausführbare Datei angemeldet ist,
  66.                wird versucht, die Datei auszuführen, ansonsten wird die Datei
  67.                angezeigt.
  68.    
  69.    Anm.: Bei Auswahl der Punkte 2) und 3) wird JetFind beendet, da es ja
  70.          nicht in einem Fenster läuft (später vielleicht).
  71.  
  72. Dadurch können Sie auch über JetFind Programme starten oder Dateien ansehen.
  73.  
  74. Die übrigen Buttons:
  75.  
  76. Driveselect:
  77. Es erscheint ein Dialog, in dem Sie die Laufwerke aussuchen können, auf
  78. denen JetFind nach Dateien suchen soll. Beim Start sucht JetFind immer
  79. nur auf dem Default-Laufwerk. Mit dem Knopf 'All' werden alle Festplatten-
  80. laufwerke auf einmal (alles größer und gleich C:) angewählt, mit dem
  81. Knopf 'None' werden alle gewählten Laufwerke deselektiert.
  82.  
  83. Clipbrd:
  84. Bei einem Klick auf diesen Knopf erscheint ein Popup-Menu, in dem
  85. Sie die Listausgabe auf das Clipboard kontrollieren können.
  86. Mit 'Liste ausgeben' wird die aktuelle File-Liste als Scrap.TXT im
  87. sogenannten 'Clipboard' gespeichert. Falls kein Clipboard-Verzeichnis
  88. existiert, wird eines angelegt.
  89. Mit 'Liste anhängen' wird ebenfalls die aktuelle File-Liste
  90. ausgegeben, nur wird diese an die Datei SCRAP.TXT im Clipboard-Verzeichnis
  91. angehängt. Falls eine solche nicht existiert, wird eine neue angelegt.
  92. Über 'Ausgabeformat' können Sie festlegen, wie die Zeilen in der Datei
  93. SCRAP.TXT aussehen sollen. Es wird immer ein Beispiel angezeigt, wie die
  94. Ausgabe aussehen wird. Sie können dort als Ausgabeelemente den Namen, den Pfad,
  95. das Datum und die Uhrzeit der letzten Änderung sowie die Dateigröße ausgeben
  96. lassen. Außerdem können Sie auch noch festlegen, ob der Pfad vor dem
  97. Dateinamen ausgegeben werden soll oder hinter dem Dateinamen (Hallo, Andreas!).
  98.  
  99. Info:
  100. Es erscheint ein Dialog mit Informationen über JetStream, ShareWare und
  101. eine sehr wichtige Kontonummer.
  102.       
  103. Quit: JetFind wird beendet, was soll da denn sonst kommen.
  104.  
  105. Löschen:
  106. Durch diesen Knopf können Sie ALLE gefundenen Dateien von JetFind löschen
  107. lassen. Vorher kommt noch eine Sicherheitsabfrage, ob Sie wirklich alle
  108. gefundenen Dateien löschen wollen. Wenn das Löschen einmal gestartet wurde,
  109. läßt es sich nicht mehr abbrechen. Seien sie also vorsichtig damit, wenn Sie
  110. diesen Knopf benutzen. Für verlorengegange Quelltexte oder sonstige Daten
  111. kann ich natürlich keine Haftung übernehmen! Eingebaut habe ich das auch
  112. nur, weil mehrere Personen das gewünscht haben.
  113.  
  114.  
  115. EX-TIP
  116. ======
  117. Hier stand einmal die Empfehlung, JetFind mit dem Accessory 'The Chameleon'
  118. von Karsten Isakovic zu benutzen. Da es jedoch in der Zusammenarbeit von
  119. JetFind, The Chameleon und GEMINI Probleme gibt (die leider am Chameleon 
  120. liegen), kann ich das im Moment nicht mehr empfehlen. Ich hoffe aber, daß 
  121. in einer zukünftigen Version vom Chameleon diese Probleme beseitigt sind. 
  122.  
  123.  
  124. WILDCARDS
  125. =========
  126.  
  127. Kommen wir nun zu den Wildcards, die in JetFind ab der Version 1.25 neu
  128. implementiert wurden. Die Auswertung der Wildcards erfolgt nun genauso wie
  129. in GEMINI, was ja auch kein Wunder ist, da es die gleiche Routine ist (Danke,
  130. Gereon). Folgende Regeln gelten: '*' steht für beliebig viele, beliebige Z
  131. Zeichen, ein '?' steht für ein beliebiges Zeichen. Im Gegensatz zum GEMDOS
  132. findet man alle Dateien über die Eingabe von '*', mit '*.*' werden nur noch
  133. die Dateien gefunden, die auch eine Extension haben. Weiterhin kann man auch
  134. Bereiche von Zeichen definieren, so z.B. [AFH], das steht dann für eines der
  135. Zeichen in den eckigen Klammern. Man kann auch direkt schreiben [A-H] anstelle
  136. alle Zeichen aufzuführen. Durch Angabe eines '^' direkt hinter der ersten
  137. eckigen Klammer wird der Ausdruck in den Klammern negiert, also [^A-F] steht für
  138. alle Zeichen außer 'A' bis 'F'.
  139. So, mehr kann ich dazu auch nicht erklären, am besten ist es, das einfach mal
  140. auszuprobieren.
  141.  
  142.  
  143. SONSTIGES
  144. =========
  145.  
  146. JetFind ist Shareware. Dies heißt, sie können JetFind ausgiebig testen, wenn
  147. es Ihnen jedoch gefällt und Sie JetFind regelmäßig benutzen, müssen Sie den
  148. Shareware-Beitrag von DM 20,-- bezahlen. Wer will, kann natürlich auch mehr
  149. bezahlen, worüber ich mich natürlich besonders freuen würde. Wohlgemerkt,
  150. 3 Zeilen weiter oben steht MÜSSEN. Falls Sie JetFind regelmäßig benutzen
  151. und nicht bezahlen, arbeiten Sie mit einer Raubkopie!
  152.  
  153. Dieses Geld überweisen Sie am besten auf folgendes Konto:
  154.  
  155.     Kreissparkasse Siegburg, BLZ 386 500 00, Konto-Nummer 104020516
  156.     
  157. Geben Sie auch bitte Ihren Namen im Verwendungszweck an, damit ich die
  158. Überweisung auch zuordnen kann.
  159.     
  160. Und noch ein Hinweis: Inzwischen stecken in JetFind auch schon recht viele
  161. Stunden Arbeit, die mir sonst keiner bezahlt. Und ich rechne auch nicht damit,
  162. jemals irgendwie diese Stunden voll bezahlt zu bekommen. Aber ich freue mich
  163. über jede Anerkennung in Form des Shareware-Beitrages.
  164.  
  165. Sie können JetFind zusammen mit allen dazugehörigen Dateien weitergeben, auch
  166. über Mailbox-Systeme. Die Verbreitung über PD-Vertriebe oder ähnliche
  167. kommerzielle Betriebe ist untersagt. Ebenfalls untersagt ist die Weitergabe
  168. von JetFind mit kommerziellen Produkten. Falls Sie dieses machen wollen, setzen
  169. Sie sich doch am besten mit mir in Verbindung, sicher läßt sich dann eine
  170. Vereinbarung aushandeln.
  171.  
  172. Meine Adresse:      Dirk Steins
  173.                     Auf dem Feldchen 48
  174.                     5216 Niederkassel-6
  175.                     DFÜ: über die Maus Bonn (0228/213230) oder als
  176.                     Dirk Steins @ BN über jede andere Box im Mausnet
  177.                     Dirk Steins % MAUS BN @ Fido 2:242/2 über Fido
  178.                     Dirk_Steins@bn.maus.de
  179.  
  180. Auch wenn Sie noch Verbesserungsvorschläge haben, können Sie diesen an diese
  181. Adresse schicken (am liebsten E-Mail!). Falls Ihnen also noch ein Feature
  182. einfällt, das Sie gerne in JetFind sehen würden, schreiben Sie es mir, ich
  183. werde sehen, was ich tun kann!
  184.  
  185. JetFind wurde komplett mit dem Megamax Modula-2 Entwicklungssystem von
  186. Application Systems Heidelberg entwickelt.
  187. Die MagicDials sind von Peter Hellinger.
  188.  
  189. Ich kann keine Haftung für irgendwelche direkten oder indirekten Schäden -
  190. einschliesslich aber nicht beschränkt auf materielle oder finanzielle -
  191. übernehmen, die durch die Benutzung von JetFind oder die Untauglichkeit
  192. von JetFind für einen bestimmten Zweck entstehen.
  193.  
  194.  
  195. DANKSAGUNG
  196. ==========
  197.  
  198. Ich danke hier an erster Stelle den 6 Leuten, die bisher den Shareware-Beitrag
  199. gezahlt haben. Ich würde mich freuen, wenn möglichst viele diesen nacheifern
  200. würden.
  201. Dann danke ich noch Peter Hellinger für die MagicLibrary, Thomas Tempelmann
  202. und Manuel Chakravarty für die schöne Entwicklungsumgebung, allen Leuten,
  203. die Verbesserungsvorschläge gemacht haben und letztendlich auch noch Atari
  204. für die Entwicklung des ST's.
  205.  
  206.  
  207. THE FUTURE
  208. ==========
  209.  
  210. Je nachdem, wie hoch die Zahlungsmoral der Leute noch wird, baue ich auch noch
  211. ein paar Verbesserungen ein. Ich denke im Moment an weitere Optionen bei der
  212. Listenausgabe auf das Clipboard (variableres Format), eventuell werfe ich auch
  213. die ganze Listenausgabe in ein Fenster, so daß man unter GEMINI immer zwischen
  214. den Fenstern umschalten kann und nicht neu suchen muß.
  215. Vielleicht baue ich auch noch das Abspeichern der Parameter ein, das ist im 
  216. Moment auch noch nicht drin.
  217. Außerdem stört mich im Moment die Größe von JetFind doch erheblich, ich wollte
  218. eigentlich ein kleines Programm schreiben. Eventuell werde ich dann halt Teile
  219. davon in Assembler neu programmieren, so daß das ganze dann hoffentlich ein
  220. paar kB kleiner wird.
  221.  
  222.  
  223. CHANGES
  224. =======
  225.  
  226. 1.0     Erste öffentliche Version
  227.  
  228. 1.01    Directorys haben jetzt einen '\' am Ende des Dateinamens.
  229.         JetFind sollte jetzt auch ohne Probleme mit 'The Chameleon' laufen.
  230.         Der Mauszeiger sollte auch nicht mehr verschwinden und auch beim
  231.         Scrollen in verschiedenen OverScan-Auflösungen sollte kein Pixelmüll
  232.         mehr erscheinen.
  233.  
  234. 1.1     Zusätzlich Ausgabe der erstellten Liste auf das Clipboard.
  235.         Jetzt wird auch auf Platten mit 12 Bit FAT's gesucht (und das natürlich
  236.         immer noch ultraschnell), kein Absturz mehr dabei.
  237.         Bei Devices, die keinen vernünftigen Biosparameterblock liefern,
  238.         wird jetzt über das GEMDOS gesucht. Damit müßten auch Devices
  239.         wie DOS-Partitionen und CD-ROM's ansprechbar und durchsuchbar
  240.         sein.
  241.  
  242. 1.2 ß   Redesign der Oberfläche, da das ganze zu unübersichtlich war.
  243.         Jetzt mehr Dialogboxen. Zusätzlich die MagicDials implementiert,
  244.         d.h. alle Dialoge sind jetzt tastenbedienbar. Außerdem wurde noch
  245.         die Zusammenarbeit mit GEMINI eingebaut. Als Folge daraus unter-
  246.         stützt JetFind jetzt auch das xAcc-Protokoll der Stufe 0.
  247.         Das Löschen der gefundenen Dateien wurde auch noch eingebaut.
  248.         Fehler bei Speicherüberlauf behoben.
  249.  
  250. 1.25 ß  Neue Wildcard-Routine, jetzt werden Wildcards, wie sie in GEMINI
  251.         verwendet werden, zum Suchen benutzt. Die Auswahl der Laufwerke ist
  252.         jetzt auch Tastaturbedienbar, dafür wurden 'All' und 'None' umbenannt.
  253.         Wer dafür etwas bessere Bezeichnungen als 'Every' und 'Clear' hat,
  254.         möchte sich doch bitte bei mir melden.
  255.         Die Speicherverwaltung wurde komplett umgestellt und ist jetzt auch
  256.         noch als Nebeneffekt teilweise deutlich schneller geworden.
  257.         
  258. 1.3     Dialogboxen optisch besser gestaltet, Anzeige des Laufwerks, auf dem 
  259.         gerade gesucht wird, eingebaut und noch einen Fehler bei zu wenig 
  260.         Speicher am Start behoben.
  261.  
  262. 1.31    Huch, wie peinlich. JetFind installierte sich nicht immer in der 
  263.         Menuzeile bei normalen ST's. Das sollte jetzt aber immer klappen,
  264.         ansonsten bitte bei mir melden. Die Popups kann man jetzt auch 
  265.         durch einen Klick mit der linken Taste außerhalb des Popups verlassen.
  266.